Java基础精炼(五): 注解

点击上方"淼淼之森"，选择"关注"公众号

优秀文章，第一时间收到！

KS

Knowledge Sharing

知识分享

    现在是资源共享的时代，同样也是知识分享的时代，如果你觉得本文有用，希望你能将它分享，让更多的人看到。

推荐阅读

Annotation

• 注解如同标签

• 对类行为的某些角度进行评价与解释

• 注解通过反射获取

注解的创建

public @interface TestAnnotation{
}

注解的使用

@TestAnnotation
public class Test{
}

元注解

可以注解到其他注解上的注解，也就是基本注解，可以用来规范注解的一些行为

@Retention --> 注解的存活周期

• RetentionPolicy.SOURCE 注解将被编译器丢弃

• RetentionPolicy.CLASS 注解在class文件中可用，但会被VM丢弃

• RetentionPolicy.RUNTIME VM将在运行期也保留注释，因此可以通过反射机制读取注解的信息。

@Documented --> 能将注解保存到Javadoc中

@Target --> 注解应用的地方

• ElementType.ANNOTATION_TYPE 可以给一个注解进行注解

• ElementType.CONSTRUCTOR 可以给构造方法进行注解

• ElementType.FIELD 可以给属性进行注解

• ElementType.LOCAL_VARIABLE 可以给局部变量进行注解

• ElementType.METHOD 可以给方法进行注解

• ElementType.PACKAGE 可以给一个包进行注解

• ElementType.PARAMETER 可以给一个方法内的参数进行注解

• ElementType.TYPE 可以给一个类型进行注解，比如类、接口、枚举

@inherited --> 如果父类使用了此注解，那么子类可以继承此注解

@Inherited
@Retention(RetentionPolicy.RUNTIME)
@interface Test {}

@Test
public class A {}

public class B extends A {}

@Repeatable --> Java8新注解，多次应用的注解

@interface Persons {
    Person[]  value();
}

@Repeatable(Persons.class)
@interface Person{
    String role default "";
}

@Person(role="artist")
@Person(role="coder")
@Person(role="PM")
public class SuperMan{
}

容器注解

存放注解的容器，本身也是注解。

注解的属性

注解的属性也叫做成员变量。

(1)、注解只有成员变量，没有方法

(2)、以无参的方法来声名

(3)、方法名为成员名

(4)、返回值为成员类型

类型必须是 8 种基本数据类型

类

接口

注解

以上各类型的数组

@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
public @interface TestAnnotation {

    int id();

    String msg();

}

在使用注解的时候，应该为该注解的属性赋值：

@TestAnnotation(id=3,msg="hello annotation")
public class Test {
}

注解中属性可以有默认值，默认值需要用 default 关键值指定：

@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
public @interface TestAnnotation {

    public int id() default -1;

    public String msg() default "Hi";

}

因此在使用的时候无需再赋初值：

@TestAnnotation()
public class Test {}

如果注解中属性名为value，那么可以省略属性名直接赋值使用

public @interface Check {
    String value();
}

@Check("hi")
int a;

内置注解

@Deprecated

@Override

@SuppressWarnings

@FunctionalInterface Java8新特性，函数式接口可以很容易转化为Lamda表达式。

注解与反射

首先可以通过 Class 对象的 isAnnotationPresent() 方法判断它是否应用了某个注解：

public boolean isAnnotationPresent(Class<? extends Annotation> annotationClass) {}

然后通过 getAnnotation() 方法来获取 Annotation 对象：

public <A extends Annotation> A getAnnotation(Class<A> annotationClass) {}

或者是 getAnnotations() 方法：

public Annotation[] getAnnotations() {}

如果获取到的Annotation不为null，则可以调用它的属性方法了：

@TestAnnotation()
public class Test {

    public static void main(String[] args) {

        boolean hasAnnotation = Test.class.isAnnotationPresent(TestAnnotation.class);

        if ( hasAnnotation ) {
            TestAnnotation testAnnotation = Test.class.getAnnotation(TestAnnotation.class);

            System.out.println("id:"+testAnnotation.id());
            System.out.println("msg:"+testAnnotation.msg());
        }
    }
}

程序运行结果：

id:-1
msg:

注解的作用

(1)、注解本身对程序运行没有直接关系

(2)、注解的存在主要是为编译器或APT(Annotation Processing Tool)使用，而要使用的话需要开发者手动调用方法来提取并处理Annotation的信息

总结

• 注解的作用是取决于你想要它做什么

-END-

目前3000+人已关注加入我们

关注公众号"淼淼之森"获取更多精彩信息：

据说幸运的人都会第一时间关注哦！